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LOS ANGELES, CA/DETROIT, 
PORTLAND, OR/PITTSBURGH, 


American 






Los Angeles, May 4-5/Detroit, May 18-19/Rochester, June 1-2 
Portland, May 11-1 2/Pittsburgh, May 28-29/Philadelphia, June 8-9 


acquired via workshop discussion, lecture and written 
assignments is to be directly applied in the six month follow-up 
service. Participants who submit actual job documentation for 
review and critique receive measurable recognition of their 
success. 

The six month follow-up service is an integral part of the study 
process. The American Institute has established an important 
precedent for its participants. Students who successfully 
complete the User Documentation program will be certified in 
this highly competitive field. 


Each participant will receive (to retain after the Workshop): 

A This manual contains outlines, 

examples, reference materials, and instructions on all the 
subjects taught in the Short Course. Case studies and 
assignments are also contained in this manual. 

A Sowcharting Kit. A template and graphic materials 
necessary to complete course assignments and aid in 
designing user documentation. 

Documentation sells the system. No system functions until the 
“how-it-works” message has been communicated and 
positively received by the people who are buying it. Clear, 
concise user documentation is required to get the message 
across— 


Managers in the Data Processing group who are respon- 
sible for preparation and distribution of documentation. 

Systems Analysts, Programmers, and Documentors who are 
assigned to write user documentation. 

Managers in the functional department who use user docu- 
mentation of computerized systems. 


In the past, documentation has been an afterthought of the 
system designer. Yet today, in an age of distributed processing, 
remote terminals and minicomputers, it must be an integral part 
of the system. Professional system builders recognize this need 
for quality user documentation. 

The American Institute presents this special purpose two-day 
seminar/workshop for EDP professionals interested in quality 
user documentation. Participants learn by doing, via case 
studies, lecture, and discussion. 

The American Institute’s Short Course is structured to facilitate 
quick, efficient assimilation of documentation skills and 
techniques. This is accomplished through a “learn and apply” 
approach, both in the classroom and on-the-job. Knowledge 


An important goal of this seminar is to improve the way 
participants handle real on-the-job documentation. To aid 
participants with their documentation work, the Course Director 
will review and critique one user manual per participant 
submitted to him within six months of the seminar. This 
Documentation Clinic is included in the seminar fee. Upon 
completion of the six month program, participants will be 
certified in the User Documentation field. 





COURSE DIRECTORS 

Donald J. Gibbs, CDPA, has over 15 years of experience in 
systems design, training, documentation and corporate 
administration of EDP. He spent several years with a national 
CPA firm where he was heavily involved in audit software. He 

also served for several years as a corporate director of data 
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processing, responsible for a multi-site operation. Currently, Mr. 
Gibbs is Director of Consulting Services with Stephen P. Radies 
& Co., a CPA firm, where he is responsible for proprietary 

software and a wide variety of consulting assignments. 

... . . ■ _ ■ 

‘Enjoyed the course and picked up several p 
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Henry I. Faber is President of CH Management, Inc., a 
management consulting organization specializing in develop- 
ing computer-based financial control systems, in-house and 
public seminars in the financial and data processing areas, 
and conducting administrative efficiency reviews. Prior to join- 
ing CH Management, Inc., Mr. Faber was affiliated with such 
organizations as ADT Security Systems and N.L. Industries. 
He also has been on the faculty for St. John’s University, New 
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York. Mr. Faber is a member of the Association for Systems 
Management and the National Association of Accountants. 
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known a month ago! Thanks for 

— Paula Ba 

senior management in my company , I had no technical knowledge of the overall course of instructs 
relating to our D.P. department, its people and its problems. Very valuable to me in specifics also; a 

- Ivan C. Peck, Moore M< 
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COURSE OUTLINE 
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Documentations What and Wt 

A. Contents 

B. Function 

1. Reference Material 

2. How-To Material 

3. Teaching Material 

C. Types of Documentation 

1. Customer Oriented 

a. Software 

b. Hardware 

2. Internal 

a. Software 

b. Hardware 

c. Policy and Procedure 

D. Case Problems 

1. Contents Matrix 

2. Audience Matrix 


Documentotion Standards 

A. The Case of Minimum Standards 

B. The Case for Style Standards 

C. Standardizing Revisions 

D. Administering Standards 

E The Standards Manual: Pro and Con 

Documentation Control and Maintenance 

A. Distribution Control 

B. Revision Control 

C. Restricted Information 

Training 

A. Purpose 

B. Planning the Training Program 

C. User Confidence 

D. Sample Training Program 

Graphics Applied to User Documentation 

A. Purpose 

B. Types 

C. Use 

Styles of User Documentation 

A. Play Script 

B. Flowchart 

C. Text 

D. Text Flowchart 
E Text-Picture 

F. Tabular 

G. Hipo 

H. Case Problem 

Contents of the User Manual 

A. Structure 

B. Segmentation 

C. Functionality 

D. Components 

E Glossaries; Tables 

Forms Design 

A. Instructions in Forms 

B. Multi-Purpose Forms 

CRT Screens and Self-Documenting Routines 

A. Format 

B. Keyboard Instructions 

C. Back-Up Documentation 
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The Documentation Plan 

A. Scoping the Documentation 

B. Defining Work Tasks 

C. Defining Documentation Tasks 

D. The Planning Worksheet 

1. Scope 

2. Tasks 

3. Man-Hour Estimates 
E Case Problems 

Documentation Economics 

A. Costs, Benefits and Company Policy 

B. Budgeting Procedures 

1. Whose Budget? 

2. What Costs? 

3. Costs of Revisions 

4. Overrun and Underrun 

5. Fixed Costs and Variable Costs 

C. Cost Estimation 

1. The Cost Worksheet 

2. Hourly Rates 

3. Purchased Items 

D. Case Problems 
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Los Angeles, CA-May 4-5, 1961 

Quality Inn 


Detroit, Ml-Moy 16-19, 1961 

Ramada Inn 

5249 West Century Blvd. 8270 Wickham Rd. 

Los Angeles, CA 90045 Romulus, Ml 48174 

213-645-2200 313-729-6300 
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Portland, OR-May 1 1-12, 1961 

Sheraton Inn Portland 

8235 N.E. Airport Way 101 Marriott Dr. 

Portland, OR 9721 8 Pittsburgh, PA 1 5205 

412-922-8400 


503-288-71 71 
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31 3-729-6300 

Pittsburgh, PA-Moy 26-29, 1961 

Pittsburgh Marriott 
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Rochester, NY-June 1-2, 1961 

Marriott 

5257 W. Henrietta Rd. 

Rochester, NY 14623 
.71 6-359-1 800 

Philadelphia, PA- June 6-9, 1961 

Philadelphia Marriott 
City Line Ave. & Monument Rd. 
Philadelphia, PA 19131 
21 5-645-6604 
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believes that offers the best possible training 

The $545 registration fee includes the seminar, available in this field. If, during the course, the participant notifies the 

Course Workbook and a Flowcharting Kit. instructor of his/her desire to withdraw, the attendee may leave and 

Three to five registrations made concurrently receive a full refund. 

from the same firm are entitled to a 10% discount. Six or more ? . The participants who successfully complete 

registrations are entitled to a 15% discount. the course are awarded 1.5 Continuing Education Units. A certificate 

Attendance level is limited and sessions tend to fill wil1 be awardecl upon request, 

up well in advance of workshop dates. To register, mail the As the national standard for the recognition of non-university 
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CANCELLATIONT: The registration fee is fully refundable up to three 
business days prior to the starting date of the seminar. All 


permanent record 

cancellations must be confirmed in writing. A charge of 50% to cover For further information about 

incurred expenses will be assessed for any cancellation after that sponsoring this workshop for groups of 15 to 30 professionals w 

date. Transfers and substitutions may be made at any time at no your organization, please contar + ^ — + — 1 o:+ ~ c — : 

charge, providing substituted session is attended. Carnegie Press, 201-822-1084. 
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HOTEL ACCOMMODATIONS: Contact the hotel directly to reserve a 
room. A block of rooms will be held at the hotels listed above until 
two weeks prior to the seminar. Please identify yourself with The 
American Institute when making your reservation. 

SCHEDULE: Classes are held from 9:00 AM. to 5:00 PM. 
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each day. 


The American Institute for Professional 
Education was founded in 1972. It is a non-profit organization serving 
the educational needs of business professionals. The American 
Institute strives to provide for the interdisciplinary needs of 
professionals in today’s rapidly expanding technological fields 
through the creation of two and three day seminars/ workshops. 
These seminars/ workshops are offered throughout the United States, 
Canada and Australia. For a current listing of sessions available, call 
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All participants will benefit from this unique 
seminar/workshop. The American Institute for Professional Education the Registrar at 201-377-7400. 
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THE AMERICAN INSTITUTE FOR 
PROFESSIONAL EDUCATION 
CARNEGIE BLDG., 100 KINGS RD. 
MADISON, NJ 07940 
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USER DOCUMENTATION 

TYPE OF REGISTRATION 

□ Single $545 

□ Multiple 

(See discount schedule) 

METHOD OF PAYMENT 

□ Check Enclosed 

□ Dill My Firm 


CHOICE OF SESSIONS 

□ Los Angeles, May 4-5 

□ Portland, May 11-12 

□ Detroit, May 18-19 

□ Pittsburgh, May 28-29 

□ Rochester, June 1 -2 

□ Philadelphia, June 8-9 


835 

TED NELSON PR£S 
PO box 128 
SWARTHMORE PA 19 
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MAILROOM: If the person on the label is no longer employed at your company, please route this 
informative brochure to his replacement, department supervisor, or training director. 

RECIPIENT NOTE: We sometimes mail to lists maintained by others over which we have no control. If 
you receive extra copies, we hope you will pass them along to interested associates. If the label is 
incorrect, or you desire a change, notify us with the 3 digit code on the label, and we will identify the 
list and the company for you. Changes should be forwarded to the list company. 
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PLEASE DO NOT REMOVE THIS MAILING LABEL 


NAME & TITLE 
NAME & TITLE 
NAME & TITLE 


ORGANIZATION 

ADDRESS 

CITY 


PHONE 


STATE 


ZIP 


Registration Phone: 201-377-7400 
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